Usenet 1993 July/InfoMagic USENET CD-ROM July 1993.ISO/sources/unix/volume6/reminders

Internet Message Format | 1986-11-30 | 24.3 KB

Subject: v06i085:  A Personal Reminder system (reminders)
Newsgroups: mod.sources
Approved: [e-mail]

Submitted by: ihnp4!allegra!novavax!don (Don Joslyn)
Mod.sources: Volume 6, Issue 85
Archive-name: reminders

[  Some sites will have to tweak the Makefile, as "install" is not a
   standard program throughout the Unix world.  I just used strip,
   followed by cp.  --r$ ]
--------------------CUT HERE--------------------
#! /bin/sh
# This is a shell archive, meaning:
# 1. Remove everything above the #! /bin/sh line.
# 2. Save the resulting text in a file.
# 3. Execute the file with /bin/sh (not csh) to create:
#    README
#    Makefile
#    rs.c
#    rs.1
# This archive created: Thu Jul  3 15:58:03 1986
# By:    Don Joslyn (Nova University, Fort Lauderdale, Florida)
export PATH; PATH=/bin:/usr/bin:$PATH
echo shar: "extracting 'README'" '(1568 characters)'
if test -f 'README'
then
    echo shar: "will not over-write existing file 'README'"
else
sed 's/^XX//' << \SHAR_EOF > 'README'
XXrs - a reminder system, by:
XX
XX    Don Joslyn, Manager
XX    Nova University Computer Center
XX    3301 College Avenue
XX    Fort Lauderdale, Florida 33314
XX    [phone]
XX    ...{codas, allegra, ucf-cs}!novavax!don
XX
XXThis directory contains the source and manual entry for the rs program.
XXSee the manual entry for more information on the use of rs.
XX
XXTo Install:
XX
XX1)    Look at rs.c and change any #defines needed.
XX    Defaults:
XX
XX        CALENDAR  "/calendar"        users calendar file.
XX        RSFILE      "/.reminders"        users reminder file.
XX        RSNOTES      "/.rsnotes"        users notes    file.
XX
XX        LPR        "/usr/ucb/lpr"    location of lpr command.
XX        EDITOR        "/usr/ucb/vi"    default editor.
XX
XX        MAXLINES    500        Max. number of lines (reminders)
XX        MAXLEN        256        Max. len of a single line.
XX
XX    If your /tmp directory is somewhere else, change rstmp.
XX    Default:    char rstmp[] = "/tmp/rsXXXXX"
XX
XX2)    Edit the Makefile.
XX
XX    Change target directory for the rs executable and manual entry
XX    if you wish.
XX
XX    Defaults:
XX
XX        DEST  = /usr/local        rs program >> /usr/local
XX        MDEST = /usr/man/manl        rs manual  >> /usr/man/manl
XX
XX    If you have something other than termcap, make the change to LIBS.
XX
XX    If you are not a BSD site, take '-DBSD' out of the Makefile so that
XX    strnchr and <string.h> will be used in place of rindex and <strings.h>
XX
XX3)    Run 'make install' which will make and install the executables and the
XX    manual entries.
XX    If you want to compile the rs program in the current directory,
XX    run 'make program'.
XX
XX------------------
XXMail questions to:
XX
XX    ...{codas, allegra, ucf-cs}!novavax!don
XX
XXThe main purpose of the rs command, is to make remembering easy!
SHAR_EOF
if test 1568 -ne "`wc -c < 'README'`"
then
    echo shar: "error transmitting 'README'" '(should have been 1568 characters)'
fi
fi
echo shar: "extracting 'Makefile'" '(513 characters)'
if test -f 'Makefile'
then
    echo shar: "will not over-write existing file 'Makefile'"
else
sed 's/^XX//' << \SHAR_EOF > 'Makefile'
XXDEST          = /usr/local
XX
XXMDEST          = /usr/man/manl/rs.l
XX
XXLDFLAGS          = -DBSD -O -w
XX
XXLIBS          = -ltermcap
XX
XXLINKER          = cc
XX
XXMANUAL          = rs.1
XX
XXPROGRAM          = rs
XX
XXSRCS          = rs.c
XX
XXall:        $(PROGRAM)
XX
XX$(PROGRAM):
XX        @echo -n "Loading rs ..."
XX        @$(LINKER) $(LDFLAGS) $(SRCS) $(LIBS) -o $(PROGRAM)
XX        @echo "done."
XX
XXinstall:    $(PROGRAM)
XX        @echo Installing $(PROGRAM) in $(DEST)
XX        @install -s $(PROGRAM) $(DEST)
XX        @echo Installing manual in $(MDEST)
XX        @cp $(MANUAL) $(MDEST)
XX
XXprogram:        $(PROGRAM)
SHAR_EOF
if test 513 -ne "`wc -c < 'Makefile'`"
then
    echo shar: "error transmitting 'Makefile'" '(should have been 513 characters)'
fi
fi
echo shar: "extracting 'rs.c'" '(13652 characters)'
if test -f 'rs.c'
then
    echo shar: "will not over-write existing file 'rs.c'"
else
sed 's/^XX//' << \SHAR_EOF > 'rs.c'
XXstatic char rcsid[] = "$Header: rs.c,v 3.3 86/07/03 14:24:34 don Exp $";
XX
XX/* $Log:    rs.c,v $
XX * Revision 3.3  86/07/03  14:24:34  don
XX * 1.  MAX_LINE (# columns on a line) now defined by termcap entry for TERM.
XX * 2.  Misc. Optimizations.
XX * 3.  Reminders can now be "marked", by appending ^G to reminder, to have
XX *     reminder highlighted during display.  "Highlight" options can be defined
XX *     in the RSINIT environment variable.
XX *     U - Underscore,  B - Bold,  S - Asterisk. (Default is standout)
XX *     I - Ignore termcap entry.
XX *
XX * Revision 3.2  85/08/26  14:55:42  don
XX * Adding Mike's enhancements.  Thanks Mike! :-)
XX * Revision 3.2 & 3.3 by Mike Spitzer @ (pur-ee!mjs)
XX *
XX * Revision 3.2  85/08/05  13:10:52  mjs
XX * -added new print_line which doesn't barf on long words
XX * -added #define for place to break up lines(MAX_LINE)
XX * -print_line is always called now, test for strlen(line) < MAX_LINE
XX *  is now made there.
XX *
XX *     MIke Spitzer
XX *     pur-ee!mjs
XX *
XX * Revision 3.1  85/07/26  20:48:06  mjs
XX * "rs" now recognizes the $EDITOR variable.  "vi" will be used if
XX * $EDITOR is undefined.
XX *
XX * added "-e" flag... does the same thing as "-v"
XX *
XX * -mjs
XX *
XX * Revision 2.2  85/02/25  10:35:48  don
XX * 1.  Optimized kill and line wrap routines.
XX * 2.  Added defines for LPR & VI.
XX * 3.  Added more RSINIT options. (A & D)
XX * 4.  Deleted add_calendar routine, now uses add_reminders.
XX * 5.  Added comments.
XX *
XX * Revision 2.1  85/01/28  17:03:56  don
XX * 1. Added new notes file - .rsnotes | command rs -n
XX * 2. Added new alternate file - user defined via setenv RSALT | command rs -A
XX * 3. Added environment variable RSINIT.
XX *    setenv RSINIT 'ad' | a = display after add | d = display after delete.
XX * 4. Lines may now be 256 char. long.
XX * 5. Long lines will automatically wrap like 'vi'.
XX * 6. Added search command. | rs -s 'search string'
XX * 7. Help deleted, replaced with 'usage' message.
XX * 8. Misc. optimizations.
XX *
XX * Revision 1.3  85/01/15  09:17:57  don
XX * 1. Added $Log line for RCS.
XX * 2. Fixed help message.
XX * 3. Coded in range deletion.
XX *  */
XX
XX/*    Program    written by:    Don Joslyn
XX *                Nova University Computer Center
XX *                3301 College Avenue
XX *                Fort Lauderdale, Florida 33314
XX *                [phone] (novavax!don)
XX *
XX *    Notice:  No Copyright.
XX *
XX*/
XX
XX#include    <stdio.h>
XX#include    <ctype.h>
XX#ifdef    BSD
XX#include    <strings.h>
XX#else
XX#include    <string.h>
XX#define        rindex    strnchr
XX#endif    BSD
XX
XX#define        MAXLEN   256    /* Max. Length of a single line     */
XX#define        MAXLINES 500    /* Max. number of lines (reminders) */
XX
XX#define        CALENDAR "/calendar"    /* calendar file */
XX#define        RSFILE     "/.reminders"    /* reminder file */
XX#define        RSNOTES  "/.rsnotes"    /* notes    file */
XX
XX#define        LPR    "/usr/ucb/lpr"    /* location of lpr */
XX#define        EDITOR    "/usr/ucb/vi"     /* default editor  */
XX
XX/*#define        BIGHELP    /* Define if you want verbose help message */
XX
XXFILE    *fp,
XX    *fptmp;
XX
XXchar    fname[128],        /* Filename tmp */
XX    on[32],            /* string used to turn "mark" on  */
XX    off[32],        /* string used to turn "mark" off */
XX    buff[1024],        /* Holds termcap entry for TERM */
XX    s[MAXLEN],        /* Tmp string and line storage */
XX    sstr[80],        /* Search string */
XX    cmd[256];        /* cmd for system call */
XX
XXchar    *a,
XX    *editor,        /* Hold for EDITOR environment variable */
XX    *entity = "Reminders",    /* Entity working on */
XX    *env,            /* Hold for RSINIT environment variable */
XX    *fun,            /* Used in arg processing */
XX    *mark_on  = "so",    /* Default mark is Standout mode */
XX    *mark_off = "se";    /* Standout end */
XX
XX
XXchar    *getenv(),
XX    *malloc(),
XX    *mktemp();
XX
XXchar    rstmp[]= "/tmp/rsXXXXXX";    /* name of temp. file during delete */
XX
XXint    adisplay = 0,    /* display reminders after additions (default = no) */
XX    ddisplay = 0,    /* display reminders after deletions (default = no) */
XX    Adisplay = 0,    /* display notes/alt after additions (default = no) */
XX    Ddisplay = 0,    /* display notes/alt after deletions (default = no) */
XX    columns = 80,    /* Number of columns in a line. */
XX    len      = 0,    /* Length of line */
XX    mark     = 0,    /* Mark the line (High Priority) */
XX    tcap     = 1,    /* Read Termcap stuff. */
XX    tcapok   = 0,    /* TERM found in Termcap file. */
XX    rem_work = 1,    /* working on reminder file by default */
XX    search   = 0,    /* search option seen on command line */
XX    status;        /* Hold status returned by sys calls and such */
XX
XXmain(argc, argv)
XXint    argc;
XXchar    *argv[];
XX{
XX
XX/* Get RSINIT environment variable to find options desired */
XX
XXenv = getenv("RSINIT");
XX
XXwhile (*env) {
XX    switch(*env++) {
XX        case 'a' : adisplay++; break;
XX        case 'd' : ddisplay++; break;
XX        case 'A' : Adisplay++; break;
XX        case 'D' : Ddisplay++; break;
XX        case 'I' : tcap = 0;   break;
XX        case 'U' :
XX            mark_on  = "us";
XX            mark_off = "ue";
XX            break;
XX        case 'B' :
XX            mark_on  = "bo";
XX            mark_off = "be";
XX            break;
XX        case 'S' :
XX            mark_on  = "ss";
XX            mark_off = "ss";
XX            break;
XX    }
XX}
XX
XX
XX/* Get users HOME directory and construct default name for reminder file */
XX
XXsprintf(fname, "%s%s", getenv("HOME"), RSFILE);
XX
XX/* Find out what the user wants to do */
XX
XXwhile ( --argc > 0 && (*++argv)[0] == '-')
XX    for (fun = argv[0]+1; *fun != '\0'; fun++)
XX        switch(*fun) {
XX        case 'A' :    /* Work on Alternate reminder file */
XX            env = getenv("RSALT");
XX            if (!env)
XX                env = "phone_numbers";
XX
XX            sprintf(fname, "%s/.%s", getenv("HOME"), env);
XX            entity = env;
XX            if (islower(entity[0]))
XX                entity[0] = toupper(entity[0]);
XX            rem_work = 0;
XX            break;
XX
XX        case 'a' :    /* Add reminder(s)/note(s)/alternate(s) */
XX            add_reminder();
XX            exit(0);
XX
XX        case 'c' :    /* Add entries to calendar file */
XX            sprintf(fname, "%s%s", getenv("HOME"), CALENDAR);
XX            entity = "Calendar commands";
XX            rem_work = 0;
XX            add_reminder();
XX            exit(0);
XX
XX        case 'd' :    /* Delete reminder(s)/note(s)/alternate(s) */
XX            delete_reminder(argc, argv);
XX            exit(0);
XX
XX        case 'k' :    /* Kill all reminders/notes/alternates */
XX            if ( unlink(fname) == 0) {
XX                printf("%s killed.\n", entity);
XX            }
XX            exit(0);
XX
XX        case 'n' :    /* Work on notes file */
XX            sprintf(fname, "%s%s", getenv("HOME"), RSNOTES);
XX            entity = "Notes";
XX            rem_work = 0;
XX            break;
XX
XX        case 'p' :    /* print reminders/notes/alternates */
XX            sprintf(cmd, "%s %s", LPR, fname);
XX            status = system(cmd);
XX
XX            if (status == 0) {
XX                printf("%s will be printed.\n", entity);
XX                exit(0);
XX            }
XX            else {
XX                printf("%s can't be printed, sorry\n", entity);
XX                exit(1);
XX            }
XX
XX        case 's' :    /* search for string in reminders/notes/alts */
XX            argc--;
XX            argv++;
XX            sprintf(sstr, "%s", argv[0]);
XX            search++;
XX            break;
XX        case 'e' : /* -e and -v are equivilent */
XX        case 'v' : /* Edit reminders/notes/alternates with editor */
XX            editor = getenv("EDITOR");
XX            if (!editor)
XX                editor = EDITOR;
XX            sprintf(cmd, "%s %s",editor,fname);
XX            system(cmd);
XX            exit(0);
XX        default:    /* Give em some help */
XX#ifndef    BIGHELP
XX            printf("Usage: rs [ -Aaceknpv ] [ -s search_string ] [ -d # ] [ -d #-# ]\n");
XX            printf("For additional information type:  man rs\n");
XX#else
XX            /* You can enable this stuff if you want! */
XX            printf("Reminder Service commands:\n\n");
XX            printf("-A\tWork on Alternate reminder file.\n");
XX            printf("-a\tAdd reminder(s)/note(s)/Alt(s).\n");
XX            printf("-c\tAdd line(s) to the calendar file.\n");
XX            printf("-d\tDelete reminder(s)/note(s)/Alt(s).\n");
XX            printf("-k\tKill all reminders/notes/Alternate.\n");
XX            printf("-n\tWork on notes.\n");
XX            printf("-p\tPrint reminders/notes/Alternates.\n");
XX            printf("-s\tSearch for string.\n");
XX            printf("-e\tEdit reminders/notes/Alt.\n\n");
XX            printf("rs with no option will display reminders.\n");
XX            printf("SEE ALSO rs(1)\n");
XX#endif    BIGHELP
XX            exit(0);
XX        }
XX
XXprint_reminders();
XX
XX}
XX
XX
XX/* ADD REMINDERS */
XX/* This routine uses cat to add lines to the reminder/note/alternate file */
XX/* If you don't like it, add your own getline routine! */
XX
XXadd_reminder()
XX{
XX    printf("Enter %s then ^d to exit:\n", entity);
XX
XX    sprintf(cmd, "%s %s","/bin/cat >>",fname);
XX    system(cmd);
XX    if ( (adisplay && rem_work) || (Adisplay && !rem_work) )
XX        print_reminders();
XX}
XX
XX
XX/* DELETE REMINDERS/NOTES/ALTERNATES */
XX
XXdelete_reminder(argc, argv)
XX    int    argc;
XX    char    *argv[];
XX{
XX    int    begin,
XX        end,
XX        delete_line[MAXLINES];
XX
XX    char    a[4], b[4];
XX
XX    register int    i        = 0,
XX            j        = 0,
XX            deleted     = 0,
XX            line_number = 0,
XX            printed     = 0;
XX
XX    argc--, argv++;
XX    for (;argc > 0; argc--, argv++) {
XX        if (alldigits(*argv)) {
XX            delete_line[atoi(*argv)] = 1;
XX        }
XX        else {
XX            i = rindex(*argv, '-');
XX            sscanf(i+1, "%s", b );
XX            j = ( strlen(*argv) - strlen(b) ) - 1;
XX            strncpy(a, *argv, j);
XX            a[j]='\0';
XX            begin = atoi(a);
XX            end   = atoi(b);
XX
XX            if (begin < end) {
XX                for (j = begin ; j < end+1 ; j++)
XX                    delete_line[j] = 1;
XX            }
XX            else {
XX                printf("Illegal range specified.\n");
XX                exit(1);
XX            }
XX        }
XX    }
XX
XX    mktemp(rstmp);
XX    if ((fptmp = fopen(rstmp,"w")) == NULL) {
XX        print_open_error_exit(rstmp);
XX    }
XX
XX    if ((fp = fopen(fname,"r")) == NULL) {
XX        print_open_error_exit(fname);
XX    }
XX
XX    while (getline(s, MAXLEN) > 0) {
XX        if (delete_line[++line_number] != 1) {
XX            fprintf(fptmp,"%s",s);
XX            printed++;
XX        }
XX        else {
XX            deleted++;
XX        }
XX    }
XX
XX    fclose(fp);
XX    fclose(fptmp);
XX
XX    status = unlink(fname);
XX    if (status != 0) {
XX        printf("Can't remove file - %s", fname);
XX        exit(1);
XX    }
XX
XX    if (printed) {
XX        if ((fp = fopen(fname,"w")) == NULL) {
XX            print_open_error_exit(fname);
XX        }
XX
XX        if ((fptmp = fopen(rstmp,"r")) == NULL) {
XX            print_open_error_exit(rstmp);
XX        }
XX
XX        while (fgets(s, MAXLEN, fptmp) != NULL) {
XX            fputs(s, fp);
XX        }
XX    }
XX
XX    fclose(fp);
XX    fclose(fptmp);
XX    status = unlink(rstmp);
XX
XX    if (deleted)
XX        printf("%d %s deleted.\n", deleted, entity );
XX
XX    if ( (ddisplay && rem_work) || (Ddisplay && !rem_work) )
XX        print_reminders();
XX}
XX
XX
XX/* PRINT REMINDERS/NOTES/ALTERNATES */
XX/* This routine will print reminders/notes/alternates */
XX/* print_line is called to do the printing with */
XX/* auto wrap.  If a search argument was given, only lines that contain the */
XX/* search string will be printed. */
XX
XXprint_reminders()
XX{
XX    register int line_number = 0;
XX
XX    if ((fp = fopen(fname,"r")) == NULL) {
XX        exit(0);
XX    }
XX
XX    if (tcap) {
XX        if (tgetent(buff, getenv("TERM")) == 1) {
XX            tcapok++;
XX            columns = tgetnum("co");
XX            if (columns <= 0)
XX                columns = 80;
XX            columns -= 6;
XX            a = on;
XX            tgetstr(mark_on,  &a);
XX            a = off;
XX            tgetstr(mark_off, &a);
XX            if (!strlen(on)) {
XX                if (tgetflag("bs"))
XX                    strcpy(on, "\010*");
XX                else {
XX                    a = on;
XX                    tgetstr("bc", &a);
XX                }
XX            }
XX        }
XX    }
XX
XX    printf("\n%s:\n", entity);
XX
XX    while ((len = getline(s, MAXLEN)) > 0) {
XX        if (search) {
XX            if (instr(s, sstr) != -1) {
XX                printf("%3d. ", ++line_number);
XX                if (tcapok)
XX                    find_mark();
XX                if (mark)
XX                    printf("%s", on);
XX                print_line(s, columns);
XX                if (mark) {
XX                    printf("%s", off);
XX                    mark = 0;
XX                }
XX            }
XX            else
XX                line_number++;
XX        }
XX        else {
XX            printf("%3d. ", ++line_number);
XX            if (tcapok)
XX                find_mark();
XX            if (mark)
XX                printf("%s", on);
XX            print_line(s, columns);
XX            if (mark) {
XX                printf("%s", off);
XX                mark = 0;
XX            }
XX        }
XX    }
XX
XX    printf("\n");
XX
XX    fclose(fp);
XX}
XX
XXgetline(s, lim)
XXchar s[];
XXint  lim;
XX{
XX    register int i = 0;
XX    register int c;
XX
XX    while (--lim > 0 && (c=getc(fp)) != EOF && c != '\n')
XX        s[i++] = c;
XX
XX    if (c == '\n')
XX        s[i++] = c;
XX
XX    s[i] = '\0';
XX
XX    return(i);
XX}
XX
XXalldigits(s)
XXregister char *s;
XX{
XX    register c = *s++;
XX
XX    do {
XX    if (!isdigit(c))
XX        return(0);
XX    }
XX    while (c = *s++);
XX
XX    return(1);
XX}
XX
XXinstr(s, t)
XXchar s[], t[];
XX{
XX    register int i, j, k;
XX
XX    for (i = 0; s[i] != '\0' ; i++) {
XX        for (j=i, k=0 ; t[k] != '\0' && s[j]==t[k] ; j++ , k++)
XX            ;
XX        if (t[k] == '\0')
XX            return(i);
XX    }
XX    return(-1);
XX}
XX
XXprint_open_error_exit(file_name)
XXchar    file_name[];
XX{
XX    printf("Can't open file - %s\n",file_name);
XX    exit(1);
XX}
XX
XX/* This routine will wrap lines greater than 75 characters long.      */
XX/* An attempt is made to break the line up after a word.  If a "word" */
XX/* is greater than 75 characters, the word will be split.             */
XX/*     pur-ee!mjs                              */
XX
XX#define SPACE    ' '
XXint print_line (line, maxlen)
XXchar    line[];            /* string to be printed */
XXunsigned int    maxlen;        /* longest line permitted for output */
XX{
XX    register int    index,    /* used in for loops */
XX                    breaking_pt,/* index in line[] at point to break line
XX                */
XX                    nospace = 0,/* set to TRUE if no space is found */
XX                    last_br_pt = 0,/* last breaking point */
XX                    line_len,    /* number of characters in line[] */
XX                    done = 0;    /* set to TRUE if finished */
XX
XX /* if line[] isn't longer than the longest line permitted, we can just
XX    print it, and return. */
XX
XX    line_len = strlen (line);
XX
XX    if (strlen (line) <= maxlen) {
XX    printf ("%s", line);
XX    return;
XX    }
XX
XX    do {
XX    /* set breaking_pt at point in line[] where we should break the line.
XX       Do this by start looking backwards from maxlen until a space is
XX       found. */
XX
XX    for (index = (maxlen + last_br_pt); line[index] != SPACE; --index) {
XX        if (index == last_br_pt) {
XX        nospace = 1;
XX        break;
XX        }
XX        if (index >= line_len) {
XX        index = line_len - 1;   /* 1 gets added to it below */
XX        done = 1;
XX        break;
XX        }
XX    }
XX    breaking_pt = index + 1;
XX
XX    /* if there is no space found, set breaking point to MAXLEN */
XX
XX    if (nospace == 1) {
XX        breaking_pt = maxlen + last_br_pt;
XX        nospace = 0;    /* reset flag */
XX    }
XX    /* print line[] up to breaking point */
XX
XX    for (index = last_br_pt; index < breaking_pt; ++index)
XX        putchar (line[index]);
XX
XX
XX        if (last_br_pt == 0) /* this is our first time through */
XX            maxlen -= 5; /* for indenting */
XX        if (!done) {
XX        if (mark)
XX            printf("%s", off);
XX
XX            printf("\n     "); /* indent */
XX
XX        if (mark)
XX            printf("%s", on);
XX    }
XX
XX    last_br_pt = breaking_pt;
XX    } while (!done);
XX}
XXfind_mark()
XX{
XX    if (s[len-2] == '\07') {
XX        mark = 1;
XX        s[len-2] = '\n';
XX        s[len-1] = '\0';
XX    }
XX}
SHAR_EOF
if test 13652 -ne "`wc -c < 'rs.c'`"
then
    echo shar: "error transmitting 'rs.c'" '(should have been 13652 characters)'
fi
fi
echo shar: "extracting 'rs.1'" '(5288 characters)'
if test -f 'rs.1'
then
    echo shar: "will not over-write existing file 'rs.1'"
else
sed 's/^XX//' << \SHAR_EOF > 'rs.1'
XX.TH RS 1 "3 July 1986"
XX.ad b
XX.SH NAME
XXrs \- reminder system
XX.SH SYNOPSIS
XX.B rs
XX[
XX.B \-Aacknpv
XX] [
XX.B \-s
XX.I string
XX] [
XX.BI \-d \0# \0#-#
XX]
XX.SH DESCRIPTION
XX.I rs
XXis a personal reminder system.
XXReminders can be displayed every time you log into the system
XXby placing the
XX.I rs
XXcommand in your
XX.I .login
XXor
XX.I .profile
XXfile.
XXThe reminder system includes three reminder files:
XX.nf
XX
XX
XX    1.    Reminders  ($HOME/.reminders)
XX    2.    Notes      ($HOME/.rsnotes)
XX    3.    User defined by setting the RSALT environment variable.
XX        (Defaults to $HOME/.phone_numbers)
XX.fi
XX.PP
XX.I Options:
XX.TP
XX.I rs
XXWith no options, print reminder list to terminal.
XX.TP
XX.B \-A
XXWork with
XX.I alternate
XXreminder file.
XXThe name of the alternate file is user defined by setting the
XX.I RSALT
XXenvironment variable.  (If
XX.I RSALT
XXis not set, the alternate file defaults to 'phone_numbers'.)
XX.TP
XX.B \-a
XXAdd reminders/notes/alternates.
XXYou are prompted to add reminders/notes/alternates.  Appending a ^G (Control-G)
XXat the end of a reminder will cause rs to mark it (Highlight) during display.  (See
XX.I RSINIT
XXbelow.)
XX.TP
XX.B \-c
XXAdd entries to calendar system.  You are prompted to add calendar entries.
XXSee
XX.I calendar(1).
XX.TP
XX.B \-d
XXDelete reminders/notes/alternates.  This option, followed by a number or
XXnumbers, causes
XX.I rs
XXto delete the specified reminders/notes/alternates.
XXMore than one number may be placed on the same command line separated by
XXblanks.
XXA range of numbers may also be specified.
XX.TP
XX.B \-e
XXEdit reminders/notes/alternates file.  If the EDITOR environment variable is
XXset, the specified EDITOR is used.  If not, vi is used by default. (-v may be
XXused in place of -e)
XX.TP
XX.B \-k
XXKill (delete) all reminders/notes/alternates.
XX.TP
XX.B \-n
XXWork on
XX.I notes
XXfile.
XX.TP
XX.B \-p
XXPrint reminders/notes/alternates.
XX(By default, does an
XX.I lpr
XXof reminder file.)
XX.TP
XX.B \-s
XXSearch for reminders/notes/alternates that match the given string.
XX.PP
XXMore than one option may follow a single "\-", for example:
XX.nf
XX.RS
XX
XXrs -na    The command for "add note."
XX.RE
XX.fi
XX.PP
XX.SH NOTES
XXTo mark a reminder (Highlight), append a ^G (Control-G) to the reminder.
XX.I rs
XXwill mark the reminder during display using one of the following:
XX.nf
XX
XX
XX    Standout
XX    Underscore.
XX    Bold
XX    Asterisk
XX
XX.fi
XXas defined in
XX.I RSINIT.
XX.PP
XX.I rs
XXlooks in the environment variable
XX.I RSINIT
XXfor additional configuration options.  Options are:
XX.nf
XX
XX
XXA    Display notes/alternates/calendar after additions.
XXD    Display notes/alternates/calendar after deletions.
XXa    Display reminders after additions.
XXd    Display reminders after deletions.
XXI    Ignore TERMCAP info during startup.
XX    (Default number of columns is 80, no mark capability)
XX
XXDefault mark is standout mode.
XX    ('so' and 'se' must be defined in termcap entry.)
XX
XXU    Use underscore (underline) to mark reminders.
XX    ('us' and 'ue' must be defined in termcap entry.)
XXB    Use Bold to mark reminders.
XX    ('bo' and 'be' must be defined in termcap entry.)
XXS    Use '*' to mark reminders.
XX    (Terminal must have 'bs'.)
XX.fi
XX.PP
XXFor example,
XXif you prefer to view your reminders/notes/alternates after
XXadditions/deletions, the
XX.I csh
XXcommand:
XX.nf
XX
XX
XX          setenv RSINIT 'aAdD'
XX
XX.fi
XXcauses
XX.I rs
XXto display your reminders/notes/alternates after additions/deletions.
XXThe above command sequence may be placed in your
XX.I .login
XXfile.
XX.PP
XXReminders/notes/alternates may be from one to 255 characters long.
XXIf a reminder is longer than one line (As defined in termcap 'co'),
XX.I rs
XXdoes automatic word wrap.
XXTo add a reminder/note/alternate longer than one line,
XXtype in the entire reminder/note/alternate and end with a single carriage
XXreturn.
XXDo
XX.B not
XXinsert carriage returns before the end of a reminder/note/alternate.
XXA single carriage return
XX.B always
XXindicates the
XX.B end
XXof a reminder.
XX.SH EXAMPLES
XX.TP
XXrs -d 1 5 8
XXDelete reminders 1, 5, 8.
XX.TP
XXrs -n -d 1-5 8
XXDelete notes 1, 2, 3, 4, 5, 8.
XX.TP
XXrs -k
XXKill all reminders.
XX.SH EXAMPLE USE OF ALTERNATE REMINDER FILE
XX.PP
XXIf you would like to have a list of phone numbers that can be accessed by the
XXreminder system, you can do the following:
XX.PP
XXSet the
XX.I RSALT
XXenvironment variable to
XX.I phone-numbers
XXby including the following command line in your
XX.I .login
XXfile:
XX.TP
XX.I "     setenv RSALT 'phone-numbers'"
XX.TP
XXUse the reminder system command:
XX.TP
XX.I "     rs -A [options]"
XX.TP
XXto work on the phone-numbers reminder file.
XX.SH EXAMPLE COMMANDS FOR PHONE-NUMBERS REMINDER FILE
XX.TP
XXrs \-A \-a
XXAdd phone numbers to the phone-numbers reminder file.
XX.TP
XXrs \-A \-s Joslyn
XXSearch for Joslyn's phone number.
XX.TP
XXrs \-A \-e
XXEdit phone-numbers.
XX.TP
XXrs \-A \-p
XXPrint phone-numbers on the line printer.
XX.TP
XXrs \-A \-d 1
XXDelete the first line from phone-numbers.
XX.SH TIPS
XXTo make use of the notes/alternates easier, the author defines two aliases:
XX.nf
XX
XXalias rsn 'rs -n'     Use rsn to work with notes file.
XXalias rsa 'rs -A'     Use rsa to work with alternate file.
XX.fi
XX.SH FILES
XX.nf
XX
XX$HOME/.reminders    User's reminders.
XX$HOME/.rsnotes      User's notes.
XX/tmp/.rs*           Used during reminder deletion.
XX$HOME/.?            Other reminder file(s) defined by RSALT.
XX.fi
XX.SH SEE ALSO
XXcalendar(1), csh(1), environ(7), lpr(1), vi(1)
XX.SH AUTHOR
XX.nf
XXDon Joslyn, Manager
XXNova University Computer Center
XX3301 College Avenue
XXFort Lauderdale, Florida 33314
XX(305) 475-7678
XX{codas, allegra, ucf-cs}!novavax!don
XX.fi
SHAR_EOF
if test 5288 -ne "`wc -c < 'rs.1'`"
then
    echo shar: "error transmitting 'rs.1'" '(should have been 5288 characters)'
fi
fi
exit 0
#    End of shell archive